This R package provides a user-friendly interface for accessing data from the BRVM, which is a regional stock exchange serving multiple West African countries. With this package, users can easily retrieve historical stock price data, trading volumes, and other financial indicators for a variety of stocks traded on the BRVM.
The package is designed to simplify the process of gathering and
analyzing financial data, making it easier for researchers, investors,
and other users to extract insights and make informed decisions based on
the information available. Overall, BRVM library is a
valuable tool for anyone looking to gain a better understanding of the
BRVM and the financial markets in West Africa.
Ce package R fournit une interface conviviale pour accéder aux données de la BRVM, qui est une bourse régionale desservant plusieurs pays d’Afrique de l’Ouest. Avec ce package, les utilisateurs peuvent facilement récupérer des données historiques sur les prix des actions, les volumes de transactions et d’autres indicateurs financiers pour une variété d’actions négociées sur la BRVM.
Le package est conçu pour simplifier le processus de collecte et d’analyse de données financières, ce qui facilite la tâche des chercheurs, des investisseurs et d’autres utilisateurs pour extraire des informations et prendre des décisions éclairées en se basant sur les informations disponibles. Dans l’ensemble, notre package R est un outil précieux pour quiconque cherche à mieux comprendre la BRVM et les marchés financiers en Afrique de l’Ouest.
You can install using CRAN version
install.packages("BRVM")
You can install the development version of BRVM from github with:
# github dev version
## We can use devtools
# install.packages("devtools")
devtools::install_github("Koffi-Fredysessie/BRVM")
# Or use remotes
# install.packages("remotes")
remotes::install_github("Koffi-Fredysessie/BRVM")
Since the size of the readme is huge due to the charts, you can visit the html version of the readme on RPubs
library(BRVM)
It receives no argument and returns BRVM tickers information such as its full name, sector and country.
# Display tickers of BRVM
tickers <- BRVM_ticker_desc()
tickers
| Ticker | Company name | Sector | Country |
|---|---|---|---|
| ABJC | SERVAIR ABIDJAN COTE D’IVOIRE | DISTRIBUTION | IVORY COAST |
| BICC | BICI COTE D’IVOIRE | FINANCE | IVORY COAST |
| BNBC | BERNABE COTE D’IVOIRE | DISTRIBUTION | IVORY COAST |
| BOAB | BANK OF AFRICA BENIN | FINANCE | BENIN |
| BOABF | BANK OF AFRICA BURKINA FASO | FINANCE | BURKINA FASO |
| BOAC | BANK OF AFRICA COTE D’IVOIRE | FINANCE | IVORY COAST |
| BOAM | BANK OF AFRICA MALI | FINANCE | MALI |
| BOAN | BANK OF AFRICA NIGER | FINANCE | NIGER |
| BOAS | BANK OF AFRICA SENEGAL | FINANCE | SENEGAL |
| CABC | SICABLE COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| CBIBF | CORIS BANK INTERNATIONAL BURKINA FASO | FINANCE | BURKINA FASO |
| CFAC | CFAO MOTORS COTE D’IVOIRE | DISTRIBUTION | IVORY COAST |
| CIEC | CIE COTE D’IVOIRE | PUBLIC SERVICE | IVORY COAST |
| ECOC | ECOBANK COTE D’IVOIRE | FINANCE | IVORY COAST |
| ETIT | Ecobank Transnational Incorporated TOGO | FINANCE | TOGO |
| FTSC | FILTISAC COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| NEIC | NEI-CEDA COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| NSBC | NSIA BANQUE COTE D’IVOIRE | FINANCE | IVORY COAST |
| NTLC | NESTLE COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| ONTBF | ONATEL BURKINA FASO | PUBLIC SERVICE | BURKINA FASO |
| ORAC | ORANGE COTE D’IVOIRE | PUBLIC SERVICE | IVORY COAST |
| ORGT | ORAGROUP TOGO | FINANCE | TOGO |
| PALC | PALM COTE D’IVOIRE | AGRICULTURE | IVORY COAST |
| PRSC | TRACTAFRIC MOTORS COTE D’IVOIRE | DISTRIBUTION | IVORY COAST |
| SAFC | SAFCA COTE D’IVOIRE | FINANCE | IVORY COAST |
| SCRC | SUCRIVOIRE COTE D’IVOIRE | AGRICULTURE | IVORY COAST |
| SDCC | SODE COTE D’IVOIRE | PUBLIC SERVICE | IVORY COAST |
| SDSC | BOLLORE TRANSPORT & LOGISTICS COTE D’IVOIRE | TRANSPORT | IVORY COAST |
| SEMC | CROWN SIEM COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| SGBC | SOCIETE GENERALE COTE D’IVOIRE | FINANCE | IVORY COAST |
| SHEC | VIVO ENERGY COTE D’IVOIRE | DISTRIBUTION | IVORY COAST |
| SIBC | SOCIETE IVOIRIENNE DE BANQUE COTE D’IVOIRE | FINANCE | IVORY COAST |
| SICC | SICOR COTE D’IVOIRE | AGRICULTURE | IVORY COAST |
| SIVC | AIR LIQUIDE COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| SLBC | SOLIBRA COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| SMBC | SMB COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| SNTS | SONATEL SENEGAL | PUBLIC SERVICE | SENEGAL |
| SOGC | SOGB COTE D’IVOIRE | AGRICULTURE | IVORY COAST |
| SPHC | SAPH COTE D’IVOIRE | AGRICULTURE | IVORY COAST |
| STAC | SETAO COTE D’IVOIRE | OTHER | IVORY COAST |
| STBC | SITAB COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| SVOC | MOVIS COTE D’IVOIRE | TRANSPORT | IVORY COAST |
| TTLC | TOTAL COTE D’IVOIRE | DISTRIBUTION | IVORY COAST |
| TTLS | TOTAL SENEGAL | DISTRIBUTION | SENEGAL |
| TTRC | TRITURAF Ste en Liquid | INDUSTRY | IVORY COAST |
| UNLC | UNILEVER COTE D’IVOIRE | INDUSTRY | IVORY COAST |
| UNXC | UNIWAX COTE D’IVOIRE | INDUSTRY | IVORY COAST |
It receives no argument and returns a table of updated data (with as table header: indexes, previous closing, closing, change (%), Year to Date Change) on all the indices available on the BRVM exchange.
the_index <- BRVM_index()
the_index
| Indexes | Previous closing | Closing | Change (%) | Year to Date Change |
|---|---|---|---|---|
| BRVM-30 | 105.11 | 105.20 | 0.09 | -0.36 |
| BRVM - AGRICULTURE | 159.12 | 162.36 | 2.04 | 2.09 |
| BRVM - OTHER SECTOR | 1091.99 | 1098.16 | 0.57 | 0.00 |
| BRVM - COMPOSITE | 208.94 | 209.33 | 0.19 | -0.36 |
| BRVM - DISTRIBUTION | 316.60 | 306.90 | -3.06 | 1.12 |
| BRVM - FINANCE | 84.89 | 85.49 | 0.71 | 0.45 |
| BRVM - INDUSTRY | 99.86 | 101.28 | 1.42 | -0.65 |
| BRVM - PRESTIGE | 97.70 | 98.39 | 0.71 | 1.05 |
| BRVM - PRINCIPAL | 102.82 | 102.85 | 0.03 | -1.06 |
| BRVM - PUBLIC SERVICES | 514.37 | 513.55 | -0.16 | -1.18 |
| BRVM - TRANSPORT | 342.90 | 342.90 | 0.00 | -3.48 |
This function will get the data of the companies listed on the BVRM
stock exchange in Rich Bourse website. The function takes a single
parameter, .symbol (which represents the “Ticker”). The
function will automatically format tickers you enter in uppercase using
toupper() and then ensure that the passed ticker is in a Google
spreadsheet of allowed tickers.
#' Displaying data of SONATEL Senegal stock
BRVM_get(.symbol = "snts")
#> # A tibble: 246 × 6
#> Date Open High Low Close Volume
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl>
#> 1 2023-01-16 14895 14900 14895 14900 4032
#> 2 2023-01-17 14850 14850 14840 14840 2962
#> 3 2023-01-18 14800 14900 14800 14900 953
#> 4 2023-01-19 14780 14800 14780 14800 12539
#> 5 2023-01-20 14900 14900 14850 14850 26471
#> 6 2023-01-23 14895 15000 14895 15000 11817
#> 7 2023-01-24 15000 15200 15000 15200 14636
#> 8 2023-01-25 15100 15200 15100 15200 32697
#> 9 2023-01-26 15200 15200 15200 15200 805
#> 10 2023-01-27 15200 15200 15200 15200 1703
#> # ℹ 236 more rows
symbols <- c("BiCc","XOM","SlbC") # We use here three tickers
data_tbl <- BRVM_get(.symbol = symbols, .from = "2020-01-01", .to = Sys.Date() - 1)
# Display the first twenty observations of the table
head(data_tbl, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2020-01-10 6500 6500 6500 6500 24 BICC
#> 2 2020-01-13 6370 6500 6370 6500 29 BICC
#> 3 2020-01-14 6495 6495 6495 6495 10 BICC
#> 4 2020-01-29 6010 6010 6010 6010 24 BICC
#> 5 2020-01-30 6000 6000 6000 6000 50 BICC
#> 6 2020-02-04 5800 5800 5800 5800 12 BICC
#> 7 2020-02-07 5650 5650 5650 5650 5 BICC
#> 8 2020-02-10 5500 5500 5500 5500 5 BICC
#> 9 2020-02-14 5300 5300 5300 5300 9 BICC
#> 10 2020-02-17 4910 4910 4910 4910 210 BICC
#> 11 2020-02-18 4910 4910 4910 4910 50 BICC
#> 12 2020-02-20 4895 4895 4895 4895 5 BICC
#> 13 2020-02-21 4895 4895 4890 4890 13 BICC
#> 14 2020-02-25 4525 4525 4525 4525 16 BICC
#> 15 2020-02-26 4435 4435 4430 4430 21 BICC
#> 16 2020-02-27 4345 4760 4335 4760 1809 BICC
#> 17 2020-03-03 4745 4750 4745 4750 11 BICC
#> 18 2020-03-05 4700 4700 4700 4700 5 BICC
#> 19 2020-03-06 4695 4695 4695 4695 6 BICC
#> 20 2020-03-11 4345 4450 4345 4450 135 BICC
# Display the last twenty elements of the table
tail(data_tbl, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2023-11-21 89500 90000 90000 90000 21 SLBC
#> 2 2023-11-22 83250 90000 83250 90000 90 SLBC
#> 3 2023-11-24 90000 90000 90000 90000 3 SLBC
#> 4 2023-12-01 89990 90000 89990 89990 2 SLBC
#> 5 2023-12-05 89950 89990 89990 89990 4 SLBC
#> 6 2023-12-06 90000 90000 89990 90000 25 SLBC
#> 7 2023-12-08 90000 90000 90000 90000 3 SLBC
#> 8 2023-12-14 88200 90000 88200 90000 4 SLBC
#> 9 2023-12-15 90000 90000 90000 90000 5 SLBC
#> 10 2023-12-18 89000 90000 89000 89000 1 SLBC
#> 11 2023-12-19 89000 89000 85000 85000 716 SLBC
#> 12 2023-12-20 79000 90000 85000 89900 10 SLBC
#> 13 2023-12-22 90000 90000 89900 90000 1 SLBC
#> 14 2023-12-26 83300 90000 83300 88495 3 SLBC
#> 15 2023-12-27 88500 88500 88495 88500 1 SLBC
#> 16 2023-12-28 83300 88500 83300 87000 13 SLBC
#> 17 2024-01-02 87000 90000 87000 90000 2 SLBC
#> 18 2024-01-04 89500 90000 89500 89500 5 SLBC
#> 19 2024-01-11 88000 89500 88000 88000 160 SLBC
#> 20 2024-01-12 88000 89500 88000 89500 11 SLBC
This function will get data of the companies listed on the BVRM stock
exchange through the sikafinance site. The function takes in a single
parameter of ticker and will auto-format the tickers you input into all
upper case by using toupper()
** NB : There is a small difference between the BRVM_get and BRVM_get1 functions. * With BRVM_get it is only possible to download tickers’ daily data. * But with BRVM_get1, you can download daily, weekly, monthly, annual tickers’ data, indices and even market capitalization.
#' Displaying data of SONATEL Senegal stock
BRVM_get1("snts")
#> # A tibble: 63 × 5
#> Date Open High Low Close
#> <date> <int> <int> <int> <int>
#> 1 2023-10-18 16250 16300 16250 16300
#> 2 2023-10-19 16400 16400 16400 16400
#> 3 2023-10-20 16400 16400 16300 16300
#> 4 2023-10-23 16300 16300 16300 16300
#> 5 2023-10-24 16300 16300 16300 16300
#> 6 2023-10-25 16300 16300 16300 16300
#> 7 2023-10-26 16265 16845 16265 16845
#> 8 2023-10-27 16800 16800 16500 16500
#> 9 2023-10-30 16300 16300 16300 16300
#> 10 2023-10-31 16305 16950 16305 16950
#> # ℹ 53 more rows
# Get daily data of all indexes
all_ind <- BRVM_get1("ALL INDEXES", Period = 0, from = "2020-01-04", to = "2023-03-24")
# display the first two tens elements of the table
head(all_ind, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2022-12-26 293. 293. 293. 293. 0 BRVMAG
#> 2 2022-12-27 292. 292. 292. 292. 0 BRVMAG
#> 3 2022-12-28 285. 285. 285. 285. 0 BRVMAG
#> 4 2022-12-29 285. 285. 285. 285. 0 BRVMAG
#> 5 2022-12-30 284. 284. 284. 284. 0 BRVMAG
#> 6 2023-01-02 283. 283. 283. 283. 0 BRVMAG
#> 7 2023-01-03 281. 281. 281. 281. 0 BRVMAG
#> 8 2023-01-04 275. 275. 275. 275. 0 BRVMAG
#> 9 2023-01-05 279. 279. 279. 279. 0 BRVMAG
#> 10 2023-01-06 269. 269. 269. 269. 0 BRVMAG
#> 11 2023-01-09 276. 276. 276. 276. 0 BRVMAG
#> 12 2023-01-10 276. 276. 276. 276. 0 BRVMAG
#> 13 2023-01-11 276. 276. 276. 276. 0 BRVMAG
#> 14 2023-01-12 275. 275. 275. 275. 0 BRVMAG
#> 15 2023-01-13 275. 275. 275. 275. 0 BRVMAG
#> 16 2023-01-16 273. 273. 273. 273. 0 BRVMAG
#> 17 2023-01-17 273. 273. 273. 273. 0 BRVMAG
#> 18 2023-01-18 271. 271. 271. 271. 0 BRVMAG
#> 19 2023-01-19 281. 281. 281. 281. 0 BRVMAG
#> 20 2023-01-20 281. 281. 281. 281. 0 BRVMAG
# display the two tens of the last elements of the table
tail(all_ind, 20)
#> # A tibble: 20 × 7
#> Date Open High Low Close Volume Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2020-02-26 4281311 4281311 4281311 4281311 0 CAPIB
#> 2 2020-02-27 4314933 4314933 4314933 4314933 0 CAPIB
#> 3 2020-02-28 4346515 4346515 4346515 4346515 0 CAPIB
#> 4 2020-03-02 4424073 4424073 4424073 4424073 0 CAPIB
#> 5 2020-03-03 4379647 4379647 4379647 4379647 0 CAPIB
#> 6 2020-03-04 4369550 4369550 4369550 4369550 0 CAPIB
#> 7 2020-03-05 4342229 4342229 4342229 4342229 0 CAPIB
#> 8 2020-03-06 4359879 4359879 4359879 4359879 0 CAPIB
#> 9 2020-03-09 4338293 4338293 4338293 4338293 0 CAPIB
#> 10 2020-03-10 4357221 4357221 4357221 4357221 0 CAPIB
#> 11 2020-03-11 4332656 4332656 4332656 4332656 0 CAPIB
#> 12 2020-03-12 4318096 4318096 4318096 4318096 0 CAPIB
#> 13 2020-03-13 4318112 4318112 4318112 4318112 0 CAPIB
#> 14 2020-03-16 4285184 4285184 4285184 4285184 0 CAPIB
#> 15 2020-03-17 4301727 4301727 4301727 4301727 0 CAPIB
#> 16 2020-03-18 4288582 4288582 4288582 4288582 0 CAPIB
#> 17 2020-03-19 4207231 4207231 4207231 4207231 0 CAPIB
#> 18 2020-03-20 4209788 4209788 4209788 4209788 0 CAPIB
#> 19 2020-03-23 4154445 4154445 4154445 4154445 0 CAPIB
#> 20 2020-03-24 4144325 4144325 4144325 4144325 0 CAPIB
# To get yearly data
yearly_data <- BRVM_get1(c("brvmtr", "BiCc", "BOAS"), Period = 365 )
# display the first two tens elements of the table
head(yearly_data, 20)
#> # A tibble: 20 × 6
#> Date Open High Low Close Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2004-01-20 88.6 89.2 72.9 89.2 BRVMTR
#> 2 2005-01-03 89.2 107. 70.7 104. BRVMTR
#> 3 2006-01-02 104. 158. 104. 153. BRVMTR
#> 4 2007-01-02 153. 275. 149. 249. BRVMTR
#> 5 2008-01-02 249. 386. 226. 296. BRVMTR
#> 6 2009-01-02 275. 296. 227. 236. BRVMTR
#> 7 2010-01-04 236. 259. 224. 238. BRVMTR
#> 8 2011-01-03 238. 249. 204. 239 BRVMTR
#> 9 2012-01-02 239 349. 201. 349. BRVMTR
#> 10 2013-01-02 349. 794. 339. 789. BRVMTR
#> 11 2014-01-02 789. 1213. 601. 1213. BRVMTR
#> 12 2015-01-02 1213. 1525. 653. 1525. BRVMTR
#> 13 2016-01-04 1525. 1525. 1216. 1432. BRVMTR
#> 14 2017-01-02 1432. 1433. 764. 1203. BRVMTR
#> 15 2018-01-02 1114. 1193. 966. 966. BRVMTR
#> 16 2019-06-03 403. 429. 311. 367. BRVMTR
#> 17 2020-01-01 367. 475. 292. 379. BRVMTR
#> 18 2021-01-04 376. 622. 325 622. BRVMTR
#> 19 2022-01-03 667. 667. 295. 342. BRVMTR
#> 20 2023-01-02 341. 414. 307. 331. BRVMTR
# display the two tens of the last elements of the table
tail(yearly_data, 20)
#> # A tibble: 20 × 6
#> Date Open High Low Close Ticker
#> <date> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 2016-01-04 10000 10700 8566 9890 BICC
#> 2 2017-01-05 9750 10000 6440 8490 BICC
#> 3 2018-01-02 8700 8750 3795 7900 BICC
#> 4 2019-01-04 7550 7550 3710 6800 BICC
#> 5 2020-01-01 6800 6890 2855 6680 BICC
#> 6 2021-01-04 6680 7525 4280 7400 BICC
#> 7 2022-01-03 7250 7250 5550 6850 BICC
#> 8 2023-01-02 6500 7495 5785 7490 BICC
#> 9 2024-01-04 7450 7485 7300 7395 BICC
#> 10 2014-12-10 1613 3225 1613 3225 BOAS
#> 11 2015-01-02 3370 4300 2900 3950 BOAS
#> 12 2016-01-04 3700 4101 2000 2350 BOAS
#> 13 2017-01-02 2325 3875 2035 2500 BOAS
#> 14 2018-01-02 2400 3250 1700 2020 BOAS
#> 15 2019-01-02 1900 2000 1500 1545 BOAS
#> 16 2020-01-01 1550 1700 1295 1495 BOAS
#> 17 2021-01-04 1480 2750 1340 2350 BOAS
#> 18 2022-01-03 2350 2780 2200 2450 BOAS
#> 19 2023-01-02 2580 3650 2175 3200 BOAS
#> 20 2024-01-01 3200 3200 3005 3165 BOAS
It receives no argument and returns the name of all indexes available on BRVM Stock Exchange.
BRVM.index()
#> [1] "BRVMAG" "BRVMC" "BRVMAS" "BRVMDI" "BRVMFI" "BRVMIN" "BRVMSP" "BRVMTR"
#> [9] "BRVMPR" "BRVMPA" "BRVM30"
This function will take in the name of sector(s) and returns data for companies belonging to that/those sector(s)
# Get informations about brvm sectors like other and agriculture sectors
BRVM_bySector(.sectors = c("Other", "Agriculture"))
#> # A tibble: 6 × 8
#> Ticker `Company name` Volume `Previous price` Open Close `Change (%)` Sector
#> <chr> <chr> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 STAC SETAO COTE D'I… 23 885 890 890 0.56 Other
#> 2 PALC PALM COTE D'IV… 6150 6885 6890 6885 -0.15 Agric…
#> 3 SCRC SUCRIVOIRE COT… 106 450 450 450 3.45 Agric…
#> 4 SICC SICOR COTE D'I… 41 3260 3525 3260 -6.59 Agric…
#> 5 SOGC SOGB COTE D'IV… 10315 3240 3195 3240 1.41 Agric…
#> 6 SPHC SAPH COTE D'IV… 7981 2355 2200 2355 7.05 Agric…
This function receives as input a day of the week (working day) and returns the official quotation revews of that day. * .weekday : A quoted date, ie. “2022-01-31” or “2022/01/31”. The date must be in ymd format “YYYY-MM-DD” or “YYYY/MM/DD”. Must not be a weekend or a holiday.
# The BOC of 2022-02-23
BRVM_stock_market("2022-02-23")
| Ticker | Equity | Volume | Value | Previous price | Open | Close | Change (%) | Annual change (%) | Reference price | Low | High | Net Income | Date | Compartment | Yield Net (%) | PER |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| INDUSTRY SECTOR | -4.85% | NA | ||||||||||||||
| CABC | SICABLE CI | 517 | 665880 | 1225 | 1225 | 1225 | 0 | 20.69 | 1225 | 1000 | 1030 | 133.00 | 02/08/2021 | 1er | 10.86 | 6.22 |
| FTSC | FILTISAC CI | 840 | 1343210 | 1560 | 1600 | 1600 | -2.5 | -7.14 | 1600 | 17020 | 19780 | 235.00 | 31/08/2021 | 1er | 14.69 | 6.35 |
| NEIC | NEI-CEDA CI | 10866 | 8915565 | 880 | 875 | 850 | -7.37 | 40.80 | 950 | 33 | 37 | 9.00 | 28/06/2021 | 1er | 0.00 | 15.14 |
| NTLC | NESTLE CI | 207 | 1168515 | 5645 | 5640 | 5645 | -0.09 | 22.58 | 5650 | 1850 | 2140 | 363.67 | 30/07/2021 | 2eme | 6.44 | 5.97 |
| SEMC | CROWN SIEM CI | 602 | 445980 | 730 | 750 | 750 | 2.74 | -1.96 | 730 | 12835 | 14915 | 14.40 | 28/12/2021 | 2eme | 1.97 | 24.97 |
| SIVC | AIR LIQUIDE CI | 1549 | 1255650 | 925 | 900 | 860 | -7.03 | -3.91 | 925 | 3980 | 4620 | 63.00 | 29/09/2020 | 1er | 0.00 | 0.00 |
| SLBC | SOLIBRA CI | 167700 | 160000 | 167700 | 4.81 | 7.50 | 160000 | 115625 | 134375 | 2736.00 | 03/08/2021 | 1er | 1.71 | 15.03 | ||
| SMBC | SMB CI | 144 | 1069980 | 7495 | 7495 | 7495 | 4.83 | 8.62 | 7150 | 7770 | 9030 | 810.00 | 15/07/2021 | 1er | 11.33 | 5.93 |
| STBC | SITAB CI | 111 | 961900 | 5800 | 5800 | 5800 | 0 | -6.15 | 5800 | 72150 | 83850 | 445.12 | 22/07/2021 | 1er | 7.52 | 12.19 |
| TTRC | TRITURAF CI | 0 | 490 | NC | NC | 0 | 0.00 | 490 | 455 | 525 | 1440.00 | 19/07/2019 | 2eme | 0.00 | 0.00 | |
| UNLC | UNILEVER CI | 0 | 0 | 4850 | NC | NC | 0 | -0.82 | 4850 | 7865 | 9135 | 1233.00 | 09/07/2020 | 2eme | 0.00 | 0.00 |
| UNXC | UNIWAX CI | 808 | 1683980 | 2085 | 2085 | 2085 | -0.24 | 4.25 | 2090 | 3885 | 4515 | 18.00 | 16/08/2021 | 2eme | 0.86 | 117.28 |
| TOTAL | 15644 | 17510660 | NA | |||||||||||||
| PUBLIC SERVICES SECTOR | -6.94% | NA | ||||||||||||||
| CIEC | CIE CI | 4192 | 8773320 | 2095 | 2100 | 2095 | -0.24 | 10.55 | 2100 | 1840 | 1695 | 153.16 | 25/07/2021 | 1er | 7.96 | 7.27 |
| ONTBF | ONATEL BF | 1238 | 5221520 | 4240 | 4210 | 4240 | 0.71 | 7.48 | 4210 | 6245 | 7255 | 399.56 | 01/06/2021 | 1er | 9.49 | 9.22 |
| SDCC | SODECI | 1285 | 4897025 | 4050 | 4100 | 3750 | -7.41 | -12.69 | 4050 | 39775 | 46225 | 337.50 | 27/08/2021 | 1er | 8.33 | 8.46 |
| SNTS | SONATEL SN | 17445 | 255870465 | 14650 | 14650 | 14650 | 0 | 4.83 | 14650 | 20305 | 23595 | 1225.00 | 21/05/2021 | 1er | 8.36 | 7.28 |
| TOTAL | 24160 | 274762330 | NA | |||||||||||||
| FINANCE SECTOR | -16.09% | NA | ||||||||||||||
| BICC | BICICI | 1275 | 7901650 | 6200 | 6200 | 6010 | -3.06 | -18.78 | 6200 | 7865 | 6090 | 50.00 | 15/07/2021 | 1er | 0.81 | 22.12 |
| BOAB | BOA BENIN | 3524 | 21132470 | 5995 | 5995 | 5995 | -0.08 | 13.11 | 6000 | 6475 | 5100 | 436.00 | 20/05/2021 | 1er | 7.27 | 9.14 |
| BOABF | BOA BURKINA FASO | 307 | 1903400 | 6200 | 6195 | 6200 | 0 | 0.00 | 6200 | 6750 | 4900 | 370.00 | 03/05/2021 | 1er | 5.97 | 7.75 |
| BOAC | BOA CI | 143 | 772200 | 5490 | 5490 | 5400 | -1.64 | -7.77 | 5490 | 3885 | 4495 | 315.00 | 12/05/2021 | 1er | 5.74 | 7.72 |
| BOAM | BOA MALI | 342 | 481920 | 1430 | 1400 | 1450 | 1.4 | -2.36 | 1430 | 21645 | 3060 | 1er | 0.00 | 49.53 | ||
| BOAN | BOA NIGER | 571 | 3399875 | 6015 | 6000 | 6015 | 0.25 | 17.94 | 6000 | 3610 | 4600 | 429.66 | 06/05/2021 | 1er | 7.16 | 10.51 |
| BOAS | BOA SENEGAL | 867 | 2145825 | 2475 | 2475 | 2475 | 0.2 | 5.32 | 2470 | 2270 | 2495 | 161.01 | 06/07/2021 | 1er | 6.52 | 7.73 |
| CBIBF | CORIS BANK INTERNATIONAL BF | 282 | 2909300 | 10800 | 10250 | 10800 | 0 | 2.86 | 10800 | 8605 | 2495 | 1er | 3.76 | 10.05 | ||
| ECOC | ECOBANK CI | 7784 | 33865535 | 4500 | 4500 | 4500 | -2.07 | -5.96 | 4595 | 14800 | 189 | 1er | 6.40 | 8.43 | ||
| ETIT | ECOBANK TRANSNATIONAL INCORPORATED (ETI TG) | 248019 | 5129708 | 20 | 20 | 20 | 0 | 11.11 | 20 | 23 | 22 | 1.21 | 28/04/2021 | 1er | 0.00 | 1.87 |
| NSBC | NSIA BANQUE CI | 335 | 1926200 | 5750 | 5750 | 5750 | 0 | -7.03 | 5750 | 14800 | 189 | 1er | 1.35 | 19.75 | ||
| ORGT | ORAGROUP TG | 982 | 3829065 | 3900 | 3900 | 3900 | -4.06 | -6.92 | 4065 | 14800 | 189 | 1er | 1.46 | 29.89 | ||
| SAFC | SAFCA CI | 132 | 131340 | 1160 | 1160 | 1075 | -7.33 | 26.47 | 1160 | 5740 | 5740 | 23.04 | 29/07/2021 | 1er | 0.00 | 0.00 |
| SGBC | SGCI | 534 | 6885855 | 6885855 | 13105 | 12995 | -0.84 | 22.65 | 13105 | 11990 | 11840 | 368.30 | 30/06/2021 | 1er | 2.81 | 6.05 |
| SIBC | SIB CI | 3339 | 13466125 | 3955 | 3955 | 4000 | 1.14 | 0.38 | 3955 | 14800 | 189 | 1er | 9.10 | 6.53 | ||
| TOTAL | 268436 | 105880468 | NA | |||||||||||||
| TRANSPORT SECTOR | 0.00% | NA | ||||||||||||||
| SDSC | BOLLORE TRANSPORT & LOGISTICS CI | 45 | 113000 | 2500 | 2400 | 2500 | 0 | -2.72 | 2550 | 3935 | 3695 | 100.00 | 11/08/2021 | 1er | 4.00 | 10.11 |
| SVOC | MOVIS CI | 0 | 0 | 2395 | NC | NC | 0 | 0.00 | 2395 | 2965 | 2900 | 270.00 | 23/07/2021 | 2eme | 0.00 | 0.00 |
| TOTAL | 45 | 113000 | NA | |||||||||||||
| AGRICULTURE SECTOR | -12.42% | NA | ||||||||||||||
| PALC | PALM CÔTE D’IVOIRE | 1310 | 11723360 | 9420 | 9295 | 8900 | -0.16 | 34.76 | 9435 | 5250 | 4800 | 1236.34 | 31/08/2021 | 2eme | 1.09 | 41.42 |
| SCRC | SUCRIVOIRE CI | 11629 | 11117870 | 1015 | 1075 | 1015 | -7.31 | 5.73 | 1095 | 735 | 1005 | 1er | 3.70 | 12.00 | ||
| SICC | SICOR CI | 4 | 21500 | 5320 | 5500 | 5000 | -6.02 | -2.34 | 5320 | 3655 | 3530 | 1919.00 | 25/09/2020 | 1er | 0.00 | 3.23 |
| SOGC | SOGB CI | 517 | 2810115 | 5500 | 5495 | 5500 | 0.09 | 10.00 | 5495 | 3795 | 2900 | 541.81 | 21/07/2021 | 1er | 4.55 | 15.51 |
| SPHC | SAPH CI | 1169 | 5962125 | 5150 | 5145 | 5150 | 0.98 | -0.87 | 5100 | 2740 | 2800 | 132.30 | 24/08/2021 | 1er | 2.59 | 17.46 |
| TOTAL | 14629 | 31634970 | NA | |||||||||||||
| DISTRIBUTION SECTOR | -1.84% | NA | ||||||||||||||
| ABJC | SERVAIR ABIDJAN CI | 1000 | 1643825 | 1650 | 1640 | 1650 | -5.44 | -5.71 | 1745 | 1148 | 1005 | 164.96 | 30/09/2020 | 1er | 0.00 | 0.00 |
| BNBC | BERNABE CI | 1088 | 2615160 | 2395 | 2395 | 2500 | 4.38 | 14.94 | 2395 | 576 | 1200 | 45.00 | 30/09/2019 | 1er | 0.00 | 25.18 |
| CFAC | CFAO MOTORS CI | 198 | 232590 | 1160 | 1160 | 1200 | 0 | -2.52 | 1160 | 605 | 430 | 22.15 | 15/07/2021 | 2eme | 1.91 | 55.67 |
| PRSC | TRACTAFRIC MOTORS CI | 252 | 1158140 | 4600 | 4600 | 4600 | 0 | 9.52 | 4600 | 10 | 2800 | 162.90 | 02/09/2021 | 1er | 3.54 | 25.28 |
| SHEC | VIVO ENERGY CI | 158 | 147150 | 925 | 925 | 925 | -0.54 | 7.56 | 930 | 1172 | 585 | 63.90 | 26/11/2020 | 2eme | 6.80 | 0.00 |
| TTLC | TOTAL CI | 8600 | 18586860 | 2160 | 2200 | 2160 | 0 | 2.86 | 2160 | 1961 | 1475 | 109.31 | 27/09/2021 | 1er | 5.06 | 17.78 |
| TTLS | TOTAL SN | 1648 | 3486710 | 2095 | 2100 | 2095 | -0.24 | 6.08 | 2100 | 1634 | 1445 | 223.60 | 30/09/2021 | 1er | 10.65 | 11.28 |
| TOTAL | 12944 | 27870435 | NA | |||||||||||||
| OTHER SECTOR | -7.48% | NA | ||||||||||||||
| STAC | SETAO CI | 6517 | 10304135 | 1805 | 1670 | 1670 | -7.48 | 147.26 | 1805 | 281 | 565 | 2eme | 3.66 | 10.45 | ||
| TOTAL | 6517 | 10304135 | NA | |||||||||||||
| TOTAL - Equities market | 342375 | 468075998 | NA |
This function will get Ticker(s) data and then plot it.
chart <- BRVM_plot("BICC") # The default colors for the up and down are green and
#chart
#It is also possible to plot stock data chart for more than one ticker
#Let's plot BICC, ETIT and BOAM stock data
chart1 <- BRVM_plot(c("BICC","ETIT", "BOAM"))
# chart1
BRVM_plot: For one ticker, you can also specify your color likeBRVM_plot("boas", up.col = "blue", down.col = "pink")for example
It receives the ticker of a company listed on the BRVM stock exchange, Turn to upper case the input by using toupper() and returns informations about the company’s RSI, Beta, Closing price, etc. .
# Get informations such us beta, RSI, Closing, Valorisation, etc. of Bank Of Africa Senegal
inform <- BRVM_company_info("BOAS")
inform
| Informations | Values |
|---|---|
| Volume (titres) | 936 |
| Volume (XOF ) | 2 962 440 |
| Ouverture | 3 165 |
| Plus haut | 3 165 |
| Plus bas | 3 165 |
| Clôture veille | 3 165 |
| Beta 1 an | 0,10 |
| RSI | 47,82 |
| Capital échangé | 0,00% |
| Valorisation | 75 960 MXOF |
- BRVM_cap() : receives no argument and returns informations about BRVM capitalization
capit_ <- BRVM_cap()
capit_
- BRVM_company_rank() : returns companies rank from the BRVM Bourse exchange according to their daily change (variation).
comp.rank <- BRVM_company_rank() #Get companies rank
comp.rank <- comp.rank%>%
arrange(desc(percent_change)) #Describe in decreasing order
comp.rank
| ticker | company_name | percent_change | rank |
|---|---|---|---|
| ORGT | ORAGROUP TOGO | 7.45 | 1.0 |
| SPHC | SAPH COTE D’IVOIRE | 7.05 | 2.0 |
| STBC | SITAB COTE D’IVOIRE | 6.19 | 3.0 |
| SCRC | SUCRIVOIRE COTE D’IVOIRE | 3.45 | 4.0 |
| TTLS | TOTAL SENEGAL | 2.13 | 5.0 |
| SLBC | SOLIBRA COTE D’IVOIRE | 1.70 | 6.0 |
| SOGC | SOGB COTE D’IVOIRE | 1.41 | 7.0 |
| SGBC | SOCIETE GENERALE COTE D’IVOIRE | 1.27 | 8.0 |
| BOAM | BANK OF AFRICA MALI | 1.03 | 9.0 |
| UNXC | UNIWAX COTE D’IVOIRE | 0.88 | 10.0 |
| BOAB | BANK OF AFRICA BENIN | 0.78 | 11.0 |
| BOAC | BANK OF AFRICA COTE D’IVOIRE | 0.74 | 12.0 |
| SHEC | VIVO ENERGY COTE D’IVOIRE | 0.67 | 13.0 |
| STAC | SETAO COTE D’IVOIRE | 0.56 | 14.0 |
| SIBC | SOCIETE IVOIRIENNE DE BANQUE COTE D’IVOIRE | 0.09 | 15.0 |
| ORAC | ORANGE COTE D’IVOIRE | 0.05 | 16.0 |
| BNBC | BERNABE COTE D’IVOIRE | 0.00 | 25.5 |
| BOAS | BANK OF AFRICA SENEGAL | 0.00 | 25.5 |
| CABC | SICABLE COTE D’IVOIRE | 0.00 | 25.5 |
| CBIBF | CORIS BANK INTERNATIONAL BURKINA FASO | 0.00 | 25.5 |
| CIEC | CIE COTE D’IVOIRE | 0.00 | 25.5 |
| ECOC | ECOBANK COTE D’IVOIRE | 0.00 | 25.5 |
| ETIT | Ecobank Transnational Incorporated TOGO | 0.00 | 25.5 |
| FTSC | FILTISAC COTE D’IVOIRE | 0.00 | 25.5 |
| NEIC | NEI-CEDA COTE D’IVOIRE | 0.00 | 25.5 |
| NSBC | NSIA BANQUE COTE D’IVOIRE | 0.00 | 25.5 |
| NTLC | NESTLE COTE D’IVOIRE | 0.00 | 25.5 |
| SAFC | SAFCA COTE D’IVOIRE | 0.00 | 25.5 |
| SDSC | BOLLORE TRANSPORT & LOGISTICS COTE D’IVOIRE | 0.00 | 25.5 |
| SEMC | CROWN SIEM COTE D’IVOIRE | 0.00 | 25.5 |
| SNTS | SONATEL SENEGAL | 0.00 | 25.5 |
| SVOC | MOVIS COTE D’IVOIRE | 0.00 | 25.5 |
| TTRC | TRITURAF Ste en Liquid | 0.00 | 25.5 |
| UNLC | UNILEVER COTE D’IVOIRE | 0.00 | 25.5 |
| BICC | BICI COTE D’IVOIRE | -0.07 | 35.0 |
| SMBC | SMB COTE D’IVOIRE | -0.14 | 36.0 |
| PALC | PALM COTE D’IVOIRE | -0.15 | 37.0 |
| BOABF | BANK OF AFRICA BURKINA FASO | -0.48 | 38.0 |
| BOAN | BANK OF AFRICA NIGER | -0.56 | 39.0 |
| SIVC | AIR LIQUIDE COTE D’IVOIRE | -0.60 | 40.0 |
| PRSC | TRACTAFRIC MOTORS COTE D’IVOIRE | -1.84 | 41.0 |
| ONTBF | ONATEL BURKINA FASO | -2.27 | 42.0 |
| CFAC | CFAO MOTORS COTE D’IVOIRE | -4.46 | 43.0 |
| ABJC | SERVAIR ABIDJAN COTE D’IVOIRE | -5.80 | 44.0 |
| TTLC | TOTAL COTE D’IVOIRE | -6.53 | 45.0 |
| SICC | SICOR COTE D’IVOIRE | -6.59 | 46.0 |
| SDCC | SODE COTE D’IVOIRE | -7.43 | 47.0 |
- BRVM_direction(“.up_or_down”) : Takes ‘Up’ or ‘Down’ and returns respectively n results for the top or flop ranking of the BRVM tickers.
# Rank in increasing order the price of shares listed on the BRVM according to daily variations.
brvm_down <- BRVM_direction("Down")
brvm_down
| Symbol | Name | Variation in percentage |
|---|---|---|
| SDCC | SODE COTE D’IVOIRE | -7.43 |
| SICC | SICOR COTE D’IVOIRE | -6.59 |
| TTLC | TOTAL COTE D’IVOIRE | -6.53 |
| ABJC | SERVAIR ABIDJAN COTE D’IVOIRE | -5.80 |
| CFAC | CFAO MOTORS COTE D’IVOIRE | -4.46 |
| ONTBF | ONATEL BURKINA FASO | -2.27 |
| PRSC | TRACTAFRIC MOTORS COTE D’IVOIRE | -1.84 |
| SIVC | AIR LIQUIDE COTE D’IVOIRE | -0.60 |
| BOAN | BANK OF AFRICA NIGER | -0.56 |
| BOABF | BANK OF AFRICA BURKINA FASO | -0.48 |
| PALC | PALM COTE D’IVOIRE | -0.15 |
| SMBC | SMB COTE D’IVOIRE | -0.14 |
| BICC | BICI COTE D’IVOIRE | -0.07 |
| BNBC | BERNABE COTE D’IVOIRE | 0.00 |
| BOAS | BANK OF AFRICA SENEGAL | 0.00 |
| CABC | SICABLE COTE D’IVOIRE | 0.00 |
| CBIBF | CORIS BANK INTERNATIONAL BURKINA FASO | 0.00 |
| CIEC | CIE COTE D’IVOIRE | 0.00 |
| ECOC | ECOBANK COTE D’IVOIRE | 0.00 |
| ETIT | Ecobank Transnational Incorporated TOGO | 0.00 |
| FTSC | FILTISAC COTE D’IVOIRE | 0.00 |
| NEIC | NEI-CEDA COTE D’IVOIRE | 0.00 |
| NSBC | NSIA BANQUE COTE D’IVOIRE | 0.00 |
| NTLC | NESTLE COTE D’IVOIRE | 0.00 |
| SAFC | SAFCA COTE D’IVOIRE | 0.00 |
| SDSC | BOLLORE TRANSPORT & LOGISTICS COTE D’IVOIRE | 0.00 |
| SEMC | CROWN SIEM COTE D’IVOIRE | 0.00 |
| SNTS | SONATEL SENEGAL | 0.00 |
| SVOC | MOVIS COTE D’IVOIRE | 0.00 |
| TTRC | TRITURAF Ste en Liquid | 0.00 |
| UNLC | UNILEVER COTE D’IVOIRE | 0.00 |
| ORAC | ORANGE COTE D’IVOIRE | 0.05 |
| SIBC | SOCIETE IVOIRIENNE DE BANQUE COTE D’IVOIRE | 0.09 |
| STAC | SETAO COTE D’IVOIRE | 0.56 |
| SHEC | VIVO ENERGY COTE D’IVOIRE | 0.67 |
| BOAC | BANK OF AFRICA COTE D’IVOIRE | 0.74 |
| BOAB | BANK OF AFRICA BENIN | 0.78 |
| UNXC | UNIWAX COTE D’IVOIRE | 0.88 |
| BOAM | BANK OF AFRICA MALI | 1.03 |
| SGBC | SOCIETE GENERALE COTE D’IVOIRE | 1.27 |
| SOGC | SOGB COTE D’IVOIRE | 1.41 |
| SLBC | SOLIBRA COTE D’IVOIRE | 1.70 |
| TTLS | TOTAL SENEGAL | 2.13 |
| SCRC | SUCRIVOIRE COTE D’IVOIRE | 3.45 |
| STBC | SITAB COTE D’IVOIRE | 6.19 |
| SPHC | SAPH COTE D’IVOIRE | 7.05 |
| ORGT | ORAGROUP TOGO | 7.45 |
- BRVM_rank : receives “top” or “flop” and a number ‘n’ and returns table of companies classification
top_or_flop : Choose between “top” or “flop”
n : is the number of companies in the classification
#To get top 15
BRVM_rank("top", 15)
#> # A tibble: 15 × 3
#> Ticker Name `Change (%)`
#> <chr> <chr> <dbl>
#> 1 ORGT ORAGROUP TOGO 7.45
#> 2 SPHC SAPH COTE D'IVOIRE 7.05
#> 3 STBC SITAB COTE D'IVOIRE 6.19
#> 4 SCRC SUCRIVOIRE COTE D'IVOIRE 3.45
#> 5 TTLS TOTAL SENEGAL 2.13
#> 6 SLBC SOLIBRA COTE D'IVOIRE 1.7
#> 7 SOGC SOGB COTE D'IVOIRE 1.41
#> 8 SGBC SOCIETE GENERALE COTE D'IVOIRE 1.27
#> 9 BOAM BANK OF AFRICA MALI 1.03
#> 10 UNXC UNIWAX COTE D'IVOIRE 0.88
#> 11 BOAB BANK OF AFRICA BENIN 0.78
#> 12 BOAC BANK OF AFRICA COTE D'IVOIRE 0.74
#> 13 SHEC VIVO ENERGY COTE D'IVOIRE 0.67
#> 14 STAC SETAO COTE D'IVOIRE 0.56
#> 15 SIBC SOCIETE IVOIRIENNE DE BANQUE COTE D'IVOIRE 0.09
#To get flop 5
BRVM_rank("flop", 5)
#> # A tibble: 5 × 3
#> Ticker Name `Change (%)`
#> <chr> <chr> <dbl>
#> 1 SDCC SODE COTE D'IVOIRE -7.43
#> 2 SICC SICOR COTE D'IVOIRE -6.59
#> 3 TTLC TOTAL COTE D'IVOIRE -6.53
#> 4 ABJC SERVAIR ABIDJAN COTE D'IVOIRE -5.8
#> 5 CFAC CFAO MOTORS COTE D'IVOIRE -4.46
- company_traded_val(“company”) : receives one company listed on the BRVM stock exchange, Turn to upper case the input by using toupper() and returns informations about the company’s traded value
company_traded_val("ontbf") # Traded value of ONATEL BURKINA FASO
#> [1] "5 615 180"
Authors :
Creator : Koffi Frederic Sessie
cph (Copyright Holder) : Koffi Frederic Sessie
License : MIT 2023, BRVM authors. All rights reserved.